Cream of the Crop 3/Cream of the Crop 3.iso/disk/gwindos.zip/GWIN.INI

Text File | 1993-11-12 | 23KB | 564 lines

;           GWIN -- HELP file MENU Application.  Mike Bonnell, 1993
; ==========================================================================
; TOP of FILE Information
; ==========================================================================
;@dark gray,White,black,White,TSize=21
;! Contents
;^dark gray
;timeout=00300


; ==========================================================================
;  GWIN HELP FILE starts here.                       (c) Mike Bonnell, 1993
; ==========================================================================

@Light Red,White,Black,White,TSize=23
!HELP
;timeout=00120
^Light red
%Size=10
#Light cyan
$020000 There are several pages (screens) devoted to HELP. To locate a given subject, use the
$020015 <F2> key and type a subject name from the list below. Use <PgUp> <PgDn> to browse.
#Light Gray
$040040 Subject
#White
$040060 Operation of GWIN     -- How to use GWIN.
$040080 Screensaver           -- Setting the screensaver timeout value.
$040100 Keys                  -- Keyboard keys that are supported by GWIN.
$040120 Color Names           -- Valid Color Names.
$040140 Text Color            -- Text Color parameter.
$040160 Size                  -- Text sizing parameter.
$040180 TopWin parameter      -- Defines window colors and text size for Menu title.
$040200 Menu Title            -- Text line for the Menu title.
$040220 Status Line Color     -- Change the appearance of the status line.
$040240 Menu Item             -- Defining a menu Item.
$040260 Program to Load       -- Defines the program or batch file to load.
$040280 Text lines            -- Displaying text on the screen.
$040300 Comment Lines         -- Full lines only.
$040320 Blank Lines           -- Use blank lines to separate a grouping of parameters.
$040340 Screen Parameter Set  -- Requirements to make a screen work properly.
$040360 Design a Menu         -- Menu creation and modification.

; ==========================================================================
;  GWIN HELP FILE -- OPERATION
; ==========================================================================

@Light Red,White,Black,White,TSize=23
!Operation of GWIN
%Size=14
#Light cyan
$020020 GWIN may be loaded from the command line or a batch file. If you type the
$020040 program name with no commandline argument, GWIN looks for the file
#White
$532040 GWIN.MNU
#Light cyan
$020060 You may create your own Help files or Menu files using another filename.ext
$020080 and name this file in a commandline argument when GWIN is loaded.  GWIN will
$020100 look along the DOS PATH for the file you name.   You should install a PATH
$020120 parameter in AUTOEXEC.BAT that points to the GWIN directory.

#light Cyan
$020150 Software Requirements:
#White
$020170 MS-DOS 5.00 or greater and a Text Editor.
#light Green
$350170 (edit.com works fine.)
#White
$020190 An additional SET parameter is required in your AUTOEXEC.BAT file. This parameter
$020210 tells GWIN where to find its files. Format is   --   SET GWINDIR=[d:]\[path].
$020230 d: is the drive letter and path is the Directory name where GWIN was installed.
$020250 If this parameter is not present in AUTOEXEC, GWIN will not load.
#Yellow
$020270 Consult yout DOS manual for the SET parameter useage.
#Light Cyan
$020340 Hardware Requirements:
#White
$020360 AT 386 or greater, 640k memory, Hard Drive (250k disk space), vga graphics.
$020380 Color Monitor. (Vga adapter must be IBM compatible.)

; ==========================================================================
;  GWIN HELP FILE -- SCREENSAVER
; ==========================================================================

@Light Red,White,Black,White,TSize=23
!Screensaver
%Size=10
#White
$010040 Format is [timeout=nnnnn]
#Light Cyan
$010060  timeout= is the parameter name and nnnnn is a numeric value ranging from 00000 to 32768
$010080  in seconds. Leading zeroes must be present.  nnnnn may also be <never>.
$010100  ex. timeout=00120  will cause the screensaver to activate after 2 minutes of no keyboard
$010120  activity.
#Light Green
$010160  GWIN's screensaver may be set to invoke at any time you choose. The acceptable values
$010175  are 00000 through 32768 in seconds.
$010190  Multiple <timeout=> parameters may be inserted in a GWIN menu file each having a different
$010205  timeout value. The current timeout value is used until another <timeout=> is encountered,
$010220  then the new value is used.
$010270  If you do not use the timeout= parameter, the screensaver will not be invoked. The screen
$010285  saver will activate only if you have a GWIN display on the screen.
#Yellow
$010320  If an application is loaded, GWIN's screensaver will not go active.
$005380  Watch the case of the letters in this parameter -- <timeout=> must be lower case.

; ==========================================================================
;  GWIN HELP FILE -- KEYS
; ==========================================================================

@Light Red,White,Black,White,TSize=23
!Keys
%Size=10
#Light Cyan
$020040 The Keyboard keys listed here are the only keys supported by GWIN. If any other key is
$020055 pressed, a message will display in the status window indicating that you have pressed
$020070 an unsupported key. The condition will not cause problems and the current screen will
$020085 remain active.
%Size=12
#White
$020130 Key Name
#Light Green
%Size=10
$120134 GWIN supports 14 Keys. They are listed below.
%Size=10
#White
$040165 <Esc>
#Light Cyan
$090165 Exit GWIN and return to DOS.
#White
$020185 <Up> <Dn>
#Light Cyan
$090185 Move the Hi-lite box to the next or previous Menu Item. <Lt> and <Rt> work, too.
#White
$030205 <Enter>
#Light Cyan
$090205 Load the Program that is surrounded by the Hi-Lite Box.
#White
$040225 <PgUp>
#Light Cyan
$090225 Display the previous Screen.
#White
$040245 <PgDn>
#Light Cyan
$090245 Display the next Screen. (If <PgDn> results in end of file, then Exit.)
#White
$040265 <Home>
#Light Cyan
$090265 Display the first screen on a file.  This is usually a MENU.
#White
$040285 <End>
#Light Cyan
$090285 Display the last screen. (Usually this is not a MENU. It marks end of file. )
#White
$040305 <F1>
#Light Cyan
$090305 Press <F1> to see a list of all Keys supported by GWIN.
#White
$040325 <F2>
#Light Cyan
$090325 Press <F2> then type the name of the HELP SUBJECT. You may type a partial name
$090340 and GWIN will load the first match found. Use <PgUp> or <PgDn> to browse.
#White
$040360 <F3>
#Light Cyan
$090360 About GWIN.
#White
$040380 <F4>
#Light Cyan
$090380 Use this to exit HELP and return to your MENU.

; ==========================================================================
;  GWIN HELP FILE -- COLOR NAMES
; ==========================================================================

@Light Red,White,Black,White,TSize=23
!Color Names
%Size=14
#White
$010040 Colors may be selected with the #Color parameter to set a line to a given color.
$010060 You should try to use the dark colors for background, and the light colors for
$010080 text. Any combination may be used, though.    You could set the background to
$010100 #White and the text to #Black  (or any other combination)   for  special effect.
$010120 The Color Names shown here are valid for the TopWin,#color,and StatusLine Color
$010140 parameters.
%Size=12
#Light Green
$010170 Dark colors:
%Size=10
#Light Cyan
$010210 Black, Blue, Cyan, Red, Green, Brown, Magenta, Dark Gray.
%Size=12
#Light Green
$010250 Light colors:
%Size=10
#light Cyan
$010290 Light Gray, Light Blue, Light Cyan, Light Red, Light Green, Light Magenta, Yellow, White.

; ==========================================================================
;  GWIN HELP FILE -- SIZE=
; ==========================================================================

@Light Red,White,Black,White,TSize=23
!Size
%Size=10
#White
$020005 Format is  [%Size=][nn]
#Light Cyan
$020020 [%Size=] is the parameter name, and [nn] is the text size.
%Size=14
#White
$010040 The %Size=nn parameter controls the textsize of all text lines following until
$010060 another %Size=nn parameter is encountered.    (The textsize of Menu Items is
$010080 fixed and cannot be changed.)
%Size=10
$010140 Valid sizes are --
#Light Green
$180140 Main Window
#Yellow
$180160 08  (8pt.)
$180180 10 (10pt.)
$180200 12 (12pt.)
$180220 14 (14pt.)
$180240 16 (16pt.)
$180260 20 (20pt.)
$180280 24 (24pt.)
$180300 28 (28pt.)
#Light Green
$280140 Title Window
#Yellow
$280160 07  (8pt.)
$280180 09 (10pt.)
$280200 11 (12pt.)
$280220 13 (14pt.)
$280240 15 (16pt.)
$280260 19 (20pt.)
$280280 23 (24pt.)
$280300 27 (28pt.)
#White
$010330 The Status line text size cannot be changed.
$010360 The text size in the Title Window is controlled by the TSize=nn parameter. See the TopWin
$010380 parameter for a more complete description of TSize=nn.

; ==========================================================================
;  GWIN HELP FILE -- TEXT COLOR
; ==========================================================================

@Light Red,White,Black,White,TSize=23
!Text Color
%Size=10
#white
$020005 Format is #[color]
#Light Cyan
$020020 # is the parameter name, and [color] is the color name.
%Size=14
#White
$020050 The #Color parameter sets the textcolor for both text and Menu Items. The new
$020070 color remains in effect until another #color parameter is encountered.
$020110 You may use the #color parameter to set the highlite box by inserting a #color
$020130 as the last line in a Screen Parameter Set. The highlite box uses the most
$020150 recent #color encountered.
%Size=12
#Light Green
$020250 Dark colors:
%Size=10
#Light Cyan
$020280 Black, Blue, Cyan, Red, Green, Brown, Magenta, Dark Gray.
%Size=12
#Light Green
$020330 Light colors:
%Size=10
#light Cyan
$020360 Light Gray, Light Blue, Light Cyan, Light Red, Light Green, Light Magenta, Yellow, White.

; ==========================================================================
;  GWIN HELP FILE -- TOPWIN
; ==========================================================================

@Light Red,White,Black,White,TSize=23
!TopWin Parameter
%Size=10
#white
$020010 Format is [@][color1,color2,color3,color4,TSize=[size]
#Light Cyan
$020030 @ is the parameter name, and color[n] is the color name for a screen element.
$020045 [size] is the text size for the Title at the top of the screen.
%Size=14
#White
$020070 The TopWin Parameter defines the start of a screen parameter set. The values
$020090 contained in the parameter define the background color for the Title Window
$020110 and the Main Window. The TSize=[size] portion defines the text size for the
$020130 Title Window.
$020160 Color1 and Color2 define the background color (Color1) and the text color
$020180 (Color2) for the Title Window.
$020210 Color3 and Color4 define the background color (Color3) and the default text
$020230 color (Color4) for the Main Window. (see note below.)
$020260 TSize=[size] defines the text size for the Title Window. (TSize=) must appear
$020290 as shown here. The case of the letters is important. TS must be CAPS and ize
$020310 must be lower case. See the Size parameter description for valid entries.
#Yellow
$020330 Note: Main Window text colors may be altered by using the #color parameter.
$020350       A comma must separate each operand in the TopWin Parameter.


; ==========================================================================
;  GWIN HELP FILE -- MENU/HELP TITLE
; ==========================================================================

@Light Red,White,Black,White,TSize=23
!Menu Title
^Light Red
%Size=10
#white
$020010 Format is  ![Text for the Title]
#Light Cyan
$020040 ! is the parameter name. Type the text that will display in the TopWin Title.
%Size=14
#White
$010100 The Menu Title displays centered in the Top Window. Use TSize=nn to set the size
$010120 of the text. The Title is used during Search to locate a specific screen for
$010140 display.
$010170 You must define a title if the search function <F2> is to be used.  The title
$010190 parameter must immediately follow the TopWin parameter.  Only one Title parameter
$010210 may be used in each Parameter Set.

; ==========================================================================
;  GWIN HELP FILE -- STATUS LINE COLOR
; ==========================================================================

@Light Red,White,Black,White,TSize=23
!Status Line Color
^Light Red
%Size=10
#white
$020010 Format is  ^ [color]
#Light Cyan
$020040 ^ is the parameter name. color is a valid color name..
%Size=14
#White
$010100 The Status line (at the bottom of the screen) may have its color set by  using
$010120 the Status Line Color parameter. You may set the color to any valid color name.
$010140 The text color in the status line cannot be altered. GWIN will pick a contrasting
$010160 color to use for the text based on the background color you name.
$010190 Only one Status Line Color parameter may be included in a parameter set.

; ==========================================================================
;  GWIN HELP FILE -- MENU ITEM
; ==========================================================================

@Light Red,White,Black,White,TSize=23
!Menu Item
^Light Red
%Size=10
#white
$020010 Format is  [xxxyyy] [text]
#Light Cyan
$010040 xxx is the graphics x coordinate, and equates to the starting column for the text display.
$010060 yyy is the graphics y coordinate, and equates to the starting row. [text] is the text to
$010080 display for this menu item.
#Yellow
$200080 Menu Item text size cannot be altered.
%Size=14
#White
$020130 The left side of the screen is 0 (zero) and the right side is 639. To show
$020150 a menu item at the left side of the screen, X = 000. Normally a menu item
$020170 is indented. A starting left side value could be 010 or 020. (One or Two
$020190 characters.)
$020210 The Top of the screen is 000 and the last location you should try to use is
$020230 380. (479 is the bottom limit, but this is under the Status Line.) Each Item
$020250 placed on the screen should be spaced far enough apart so that the Hi-Lite
$020270 box will not interfere with your text.

$020300 Example --   020120
#White
$185300 ProComm

#White
$020320 will display the word,
#Light Cyan
$195320 ProComm
#White
$265320 slightly in from the left edge of the screen
$020340 and about 12 character heights down from the top of the Window. To place the
$020360 next line directly below this one, use -- 020140 [text].
#Light Cyan
$010380 This line is positioned at 010380. It's text only, so the Size= was set to 14.


; ==========================================================================
;  GWIN HELP FILE -- PROGRAM TO LOAD
; ==========================================================================

@Light Red,White,Black,White,TSize=23
!Program to Load
^Light Red
%Size=10
#White
$020010 Format is  & [d:]\[path]\[progname.ext]
$020040 & is the parameter name.
#Light Cyan
$020060 [d:] is the drive letter, [path] is the DOS path, and [progname.ext] is the name of the
$020075 program, batchfile, or DOS function to be executed. The maximum Number of Menu Items per
$020090 screen is determined by the total length of all <Program to Load> parameters.
$020120 The maximum size of the [path] area is is 1024 characters. This is normally enough to
$020135 contain 30 - 35 Menu Items per screen. The number of Menu Screens available is unlimited.
%Size=14
#White
$010200 The & (program to load) parameter must immediately follow its' respective Menu
$010220 Item. When A Menu Item is selected, GWIN will try to load and execute whatever
$010240 is named in this parameter.
$010280 The [d:] and [path] portions are optional -- GWIN will search along the DOS PATH
$010300 to locate the named program.

; ==========================================================================
;  GWIN HELP FILE -- TEXT LINES
; ==========================================================================

@Light Red,White,Black,White,TSize=23
!Text Lines
^Light Red
%Size=10
#white
$020010 Format is  $ [xxxyyy] [text]
$020040 $ is the parameter name.
#Light Cyan
$020060 [xxxyyy] is the screen coordinates, and [text] is the user text to be displayed.
%Size=14
#White
$020100 An entire screen may be filled with text for use as a HELP FILE, or single
$020120 lines (or a single word) may be positioned anywhere on the screen to clarify
$020140 something. When combined with the Text Color parameter and the Text Size
$020160 parameter, you are able to create custom screens for any purpose.
$020200 See the Menu Item Parameter for use of the screen xxxyyy coordinates.)

; ==========================================================================
;  GWIN HELP FILE -- COMMENT LINES
; ==========================================================================

@Light Red,White,Black,White,TSize=23
!Comment Lines
^Light Red
%Size=10
#white
$020010 Format is  ; [text]
#Light Cyan
$020040 ; is the parameter name. [text] is any text associated with the comment.
%Size=14
#White
$020100 GWIN supports standard comment lines that have a semi-colon in column one
$020120 and some text following -- (or no text.)
$020150 The semi-colon must be in column one, making the entire line a comment.
$020170 Partial comment lines are not supported.

; ==========================================================================
;  GWIN HELP FILE -- BLANK LINES
; ==========================================================================

@Light Red,White,Black,White,TSize=23
!Blank Lines
^Light Red
%Size=14
#White
$020100 Blank lines may be inserted anywhere to separate a parameter set, or to
$020130 separate groupings within a set.  Blank lines must contain only spaces.
#Yellow
$020160 Use the Comment line for comments.

; ==========================================================================
;  GWIN HELP FILE -- SCREEN PARAMETER SET
; ==========================================================================

@Light Red,White,Black,White,TSize=23
!Screen Parameter Set
^Light Red
%Size=14
#White
$070030 The minimum requirements to make a screen work properly are --
$070060 1)  The first line of each set must be a TopWin parameter.
$070080 2)  The second Line must be a Menu Title.
$070100 3)  Other Parameters are optional. Use them as needed.
$070130 The parameters used to create this text screen are --
$200160 @Light Red,White,Black,White,TSize=23
$200180 !Screen Parameter Set
$200200 ^Light Red
$200220 %Size=14
$200240 #White
$070270 followed by the $xxxyyy [text] lines and the Dummy Menu Item.

; ==========================================================================
;  GWIN HELP FILE -- DESIGN A MENU
; ==========================================================================

@Light Red,White,Black,White,TSize=23
!Design a Menu
^Light Red
%Size=10
#White
$030095 Creating a new Menu or HELP file may be accomplished by using the sample menu file
$030110 and making new Menu Items and Text Lines corresponding with the applications you
$030125 want your people to use. Make a copy of GWIN.MNU.

$030145 There are two working Menus contained in this file in different formats, so you
$030160 should be able to customize them to suit your needs.

$030180 If you keep the original GWIN.MNU file untouched and only modify the copy, any
$030195 changes you make will not hurt anything. Experimentation may be necessary until
$030210 you become comfortable with GWIN's parameter set and the screen handling technique
$030225 used to display your Menus and Help files.

$030245 Read the Help portion of GWIN.INI for parameter useage. Look at the Parameter Sets
$030260 that are pre-defined in this file and try to model your first efforts after these.
$030275 Use the <F10> function to load your file into the DOS 5.00 text editor, make your
$030290 changes, and then go back to GWIN to see the effect. Don't try to modify GWIN.INI.
$030305 It is used throughout for online help.


; ==========================================================================
;  GWIN HELP FILE -- DESCRIPTION OF GWIN
; ==========================================================================

@red,White,Black,White,TSize=23
!Description of GWIN
^Blue
#Light Gray
%Size=10
$030020 GWIN was designed to be a textfile display program. The intent was to allow a user to
$010035 design HELP files for use in a business environment that could be displayed in GRAPHICS
$010050 mode. This mode allows the size of text and text color to be altered to draw attention
$010065 to something on the screen. Unlike text mode applications, the GWIN GRAPHICS environment
$010080 provides the designer with the tools to write HELP that makes an impact.

$030100 Since most users have a Menu Application of some sort, we added that function to GWIN,
$010115 making the need for separate Applications  unnecessary. The GWIN Menus may be as simple
$010130 or complex as you choose.

$030150 The screensaver, although not as comprehensive as others, does provide a <broken glass>
$010165 display and may be either used or not, as you choose. It uses a separate program that may
$010180 be activated from the command line, from a Menu choice or from within GWIN.

$010200 The program name is <GSAVR.EXE> and may be invoked by using the timeout= parameter within
$010215 GWIN.

$010235 GDSK.exe is a utility that will calculate and display the free space on a diskette or hard
$010250 drive. format is GDSK [d:]

#Light Gray
%Size=14
$045340 We hope you will get some good use out of this application. Although no
$045360 known problems exist, we appreciate your input and will resolve problems
$045380 as we are made aware of them.


; ==========================================================================
;  GWIN HELP FILE -- END OF FILE  ( NOTHING BEYOND THIS PARAMETER SET. )
; ==========================================================================

@red,White,Blue,White,TSize=23
!End of File
;timeout=00020

#White
%Size=12
$180030 GWIN Setup File -- Mike Bonnell, 1993